SetTrackLayer
TheSetTrackLayerfunction allows your application to set a track's layer.
pascal void SetTrackLayer (Track theTrack, short layer);
theTrack- Specifies the track for this operation. Your application obtains this track identifier from such Movie Toolbox functions as
NewMovieTrackandGetMovieTrack(described on page 2-136 and page 2-188, respectively).layer- Specifies the track's layer number. Layers are numbered from -32,768 through 32,767. When you create a new track, the Movie Toolbox sets its track number to 0.
DESCRIPTION
Track layers are numbered from -32,768 through 32,767. You can use layers to control how tracks are combined to create a movie. The Movie Toolbox displays layers by layer number. That is, the Movie Toolbox displays higher-numbered layers first, placing lower-numbered layers on top of them. If your movie has more than one track in the same layer, the Movie Toolbox displays those layers in order by track index value, displaying higher-numbered tracks first.ERROR CODES
invalidTrack -2009 This track is corrupted or invalid SEE ALSO
You can retrieve a track's layer number by calling theGetTrackLayerfunction, which is described in the next section.